package cn.iocoder.yudao.module.cms.agreement.service;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.cms.agreement.bo.AgreementIdentifyBO;
import cn.iocoder.yudao.module.cms.agreement.dal.dataobject.AgreementDO;
import cn.iocoder.yudao.module.cms.agreement.vo.AgreementCreateReqVO;
import cn.iocoder.yudao.module.cms.agreement.vo.AgreementPageReqVO;
import cn.iocoder.yudao.module.cms.agreement.vo.AgreementUpdateReqVO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 协议规则 Service 实现类
 *
 * @author 山野羡民
 */
public interface AgreementService {

    /**
     * 创建协议规则
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createAgreement(@Valid AgreementCreateReqVO createReqVO);

    /**
     * 更新协议规则
     *
     * @param updateReqVO 更新信息
     */
    void updateAgreement(@Valid AgreementUpdateReqVO updateReqVO);

    /**
     * 删除协议规则
     *
     * @param id 编号
     */
    void deleteAgreement(Long id);

    /**
     * 获得协议规则
     *
     * @param id 编号
     * @return 协议规则
     */
    AgreementDO getAgreement(Long id);

    /**
     * 获得协议规则分页
     *
     * @param pageReqVO 分页查询
     * @return 协议规则分页
     */
    PageResult<AgreementDO> getAgreementPage(AgreementPageReqVO pageReqVO);

    /**
     * 获得协议规则标识列表
     *
     * @return 协议规则标识列表
     */
    List<AgreementIdentifyBO> getAllIdentify();

    /**
     * 获得协议规则最新内容
     *
     * @param identify 标识
     * @return 协议规则
     */
    AgreementDO getContent(String identify);

}
